home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 045a / jetcol23.zip / JETCOL.DOC < prev    next >
Text File  |  1993-02-16  |  25KB  |  624 lines
  1.                                 JETCOL
  2.  
  3.                          Shareware Version 2.3
  4.  
  5.                       A Compressed Print Utility
  6.  
  7.                          Copyright 1990-1993
  8.                                   by
  9.  
  10.                           ARCaine Technology
  11.                             960 Neilson St
  12.                            Albany, CA 94706
  13.                             (510) 527-9859
  14.  
  15.                           All Rights Reserved
  16.  
  17.  
  18.  
  19. YE OLDE DISCLAIMER
  20.  
  21.   This software and manual are sold "as is" and without warranties
  22.   as to performance or merchantability or any other warranties
  23.   whether expressed or implied. Because of the various hardware and
  24.   software environments into which this program may be put, no
  25.   warranty of fitness for a particular purpose is offered. The user
  26.   must assume the entire risk of using and evaluating this program.
  27.   Any liability of the seller will be limited exclusively to product
  28.   replacement or refund of purchase price.
  29.  
  30.  
  31. Introduction
  32.  
  33.   JETCOL prints two columns, each up to ninety characters wide, on
  34.   laser printers in portrait mode. It is intended to greatly
  35.   reduce the huge volume of paper that results from printing
  36.   reference material (such as shareware manuals), word processing
  37.   drafts and text files. Regular use of this program should cut your
  38.   paper bill by 60 or 70 percent. It can also save you money when
  39.   faxing or mailing documents.
  40.  
  41.   JETCOL has been designed to be very easy to use. Its default
  42.   settings should cover most printing needs. To print a document you
  43.   simply type:JETCOL filename <enter>. For example, to print the
  44.   manual type:JETCOL JETCOL.DOC <enter>.
  45.  
  46.   It provides better readability than other compressed print
  47.   programs because it normally ignores page breaks and eliminates
  48.   consecutive blank lines (at your option).By eliminating
  49.   more unnecessary white space on the page JETCOL can use a
  50.   larger,more readable, type face while printing the same number of
  51.   average pages/sheet as other compressed print programs. It is
  52.   designed to take maximum advantage of laserjet features to further
  53.   enhance readability. JETCOL will print anywhere from two to ten
  54.   pages of source material on one side of a sheet of paper. By using
  55.   its even/odd alternate side print feature four to twenty pages of
  56.   text can be printed using both sides of a page.
  57.  
  58.   By reducing the volume of paper, JETCOL also reduces storage
  59.   requirements and the bulk one has to carry around when traveling.
  60.  
  61.   As a side benefit, many JETCOL users actually find it easier and
  62.   faster to read the compressed versions than the originals because
  63.   they can take in more words at one time without having to scan
  64.   across the page.
  65.  
  66.   JETCOL has been tested on several brands and models of laser
  67.   printers. If you run into difficulty with your model, please let
  68.   me know and I will try to provide a version that is compatible
  69.   with your printer.
  70.  
  71.   Eight different font sizes have been specially designed for
  72.   JETCOL. These fonts are automatically selected and downloaded
  73.   according to the degree of compression requested when you specify
  74.   the number of lines each column should contain with the -Lxx
  75.   option (anywhere from 50 to 240).Also at the user's option JETCOL
  76.   will override its automatic font selection and pick either a
  77.   larger or smaller font for a given line spacing to provide either
  78.   more or less white space between lines.
  79.  
  80.   The font is nominally pitched at 21.5 characters/inch to allow
  81.   adequate space for a left margin and two 80 character columns.
  82.   When either a smaller margin is specified (-Mx) or the number of
  83.   characters/column is reduced (-Wx) the character spacing is
  84.   automatically expanded for further readability. The default margin
  85.   is seven spaces and the default column width is 80 characters.
  86.  
  87.   Some users have said that they would prefer a thinner font for
  88.   JETCOL. I have provided a new thin font in the two most often used
  89.   sizes: Fonts 6 and 7.
  90.  
  91.   A demo mode (-K) is now available to help you explore the
  92.   registered features. The demo mode will activate all registered
  93.   features but will only print one page. By running the file
  94.   DEMOJET.BAT you will see examples of the many possible printing
  95.   modes of JETCOL.
  96.  
  97.   JETCOL may be executed via a path statement but all font files
  98.   must be located in the same sub-directory as JETCOL.EXE if they
  99.   are to be found by the program when it comes time to download
  100.   them.
  101.  
  102.  
  103. Suitability
  104.  
  105.   Compressed print programs are not for everyone. You should
  106.   carefully explore how much compression you are comfortable with
  107.   before eyestrain becomes a problem. The greater degrees of
  108.   compresssion are intended more for archival use than for documents
  109.   which will be frequently read.
  110.  
  111.   This program should run on any PC compatible computer with at
  112.   least 256K of memory.
  113.  
  114.  
  115. Registration
  116.  
  117.   I will keep improving the program if I know enough people are
  118.   finding it useful.
  119.  
  120.   My registration policy is very flexible. The nominal fee is $30 US
  121.   If you don't feel you will get $30 worth of use out of the
  122.   program,then send whatever it is worth to you.
  123.  
  124.   Those who register for the full amount (and include $3 S&H) will
  125.   receive the latest JETCOL plus a set of related shareware programs
  126.   including 2COL for dotmatrix and DeskJet, a label making program,
  127.   and conversion utilities which may help you print word processor
  128.   formatted files.
  129.  
  130.   This is not freeware or public domain. Shareware is simply a
  131.   distribution method for commercial software. You are required to
  132.   register if you intend to use this program after a reasonable
  133.   trial period.
  134.  
  135.   The registered version of JETCOL permits multiple document names
  136.   and wildcards to be used on the command line and eliminates the
  137.   registration screen. It allows output to be directed to a file
  138.   instead of the printer. It also allows the automatic font
  139.   selection to be overridden to customize the document appearance to
  140.   your taste as well as selection of thinner fonts. The standard
  141.   registered version comes with 2 thin fonts and 8 regular fonts.
  142.   The registered version also allows customizing of default
  143.   settings.
  144.  
  145.   Please tell me the version number you have when registering and
  146.   where you obtained your copy of JETCOL. Registration checks should
  147.   be made payable to "Tony Caine". JETCOL should be registered for
  148.   the number of copies that can be used simultaneously. In other
  149.   words, treat it like a book.
  150.  
  151.   Site fees for commercial users can be negotiated.
  152.  
  153.   JETCOL comes with a full money-back guarantee.
  154.  
  155.   Optional Extras:
  156.  
  157.   Complete set of thin fonts (1-8)                           $10
  158.   Complete set of foreign langauge chars (ASCII 128-159)     $10
  159.  
  160.  
  161.   ATTENTION CURRENTLY REGISTERED USERS:
  162.   The new customized default settings required that I change over to
  163.   individualized registration numbers. This means that registered
  164.   users of versions 1.4 and below will need to upgrade ($10 fee) to
  165.   use this new version.
  166.  
  167.  
  168. Registered version features
  169.  
  170. (Most of these features are activated by the (-K) demo mode option.)
  171.  
  172. *Custom default settings
  173.  
  174.    JETCOL's default settings can be modified by the user. This
  175.    eliminates the need for the user to enter a string of options
  176.    whenever they run the program. They need only enter the filename.
  177.  
  178.  
  179. * Automargin
  180.  
  181.    The automargin option significantly improves the readability and
  182.    appearance of your document. It scans the entire document before
  183.    printing, determines how much blank space there is and expands
  184.    the lines to utilize this wasted space. The result is a less
  185.    crowded, easier to read document. Automargin also automatically
  186.    activates the wordwrap (-&) feature if any line in the document
  187.    is greater than the specified columnwidth (-W).
  188.  
  189.    To get an idea of what the automargin does, first type: JETCOL
  190.    JETCOL.DOC <enter>. This prints with the default settings which
  191.    are designed to accommodate any documents up to 80 characters
  192.    wide. Next type: JETCOL JETCOL.DOC -K -U9 <enter>. Compare the
  193.    two printouts for readability and appearance.
  194.  
  195.  
  196. *Fixpage
  197.  
  198.    Prints an exact number of pages/column. Original pagebreaks and
  199.    formatting retained.
  200.  
  201.  
  202. *Biasfont
  203.  
  204.    Modify font selection process to give you either more or less
  205.    white space between lines.
  206.  
  207. *Thinfont
  208.  
  209.    Selects a thinner (less bold) font.
  210.  
  211.  
  212. * Multiple document names
  213.  
  214.    Multiple document names and wildcards can be entered on the
  215.    command line.
  216.  
  217.  
  218. * Append
  219.  
  220.    When specifying multiple documents to print, registered users
  221.    have the choice of starting each file at the beginning of a page
  222.    or treating all documents as one continuous file without breaks.
  223.  
  224.  
  225. * Redirection of output
  226.  
  227.    Registered users can choose to send the output to a disk file for
  228.    later printing in background (while running other programs) or
  229.    send to LPT2, COM1, COM2, etc.
  230.  
  231. * The registration screen is eliminated, of course.
  232.  
  233.  
  234.  
  235. Terminology
  236.  
  237.   Since several pages from the original source file are combined
  238.   onto a single page of printer output, there may be some confusion
  239.   about the word "page." We will always refer to the original
  240.   document pages as "source pages." What is actually printed will
  241.   simply be called "pages."
  242.  
  243.  
  244.  
  245. Usage:
  246.  
  247.   JETCOL  [options] path\filename [options] [path\filename]...
  248.  
  249.  
  250.   Options may be specified in any order before and/or after the file
  251.   name(s). Options must be separated from each other by spaces and
  252.   preceded by a "-". Upper and lower case are interchangeable. Each
  253.   option, no matter where it is located, will affect the printing of
  254.   all files equally.
  255.  
  256.  
  257.  
  258.  
  259.   Options are defined as follows:
  260.  
  261.    -Lxx = Each column will be xx lines long
  262.    -Cxx = No more than xx consecutive blank lines will be printed
  263.    -Sxx = Skip xx pages before starting to print
  264.    -O   = Print only odd # pages
  265.    -E   = Print only even # pages
  266.    -Wxx = column width (number of characters in each column)
  267.    -P   = Pause before printing each page.
  268.    -N   = Prints filename and page # at lower left corner
  269.    -D   = Delimit each (source) page with a line and page #
  270.    -T   = Truncate long lines instead of wrap.
  271.    -Fx  = Put a margin of x blank lines at the top of each page.
  272.    -Mx  = Set left margin x spaces from the edge.
  273.    -Rx  = Create a right margin of x spaces.
  274.    -K   = Activates registered options for a one page demo.
  275.    -?   = JETCOL will ask for filenames to print
  276.    -V   = Report # pages to print.Modify spacing to fill last page
  277.    -&xx = Wordwrap long lines. (useful for .WRI and similar files)
  278.    ?    = (no dash) Prints help screen. Must be the only option.
  279.  
  280.    ***Options below are available in the registered version only***
  281.  
  282.    -A   = Append multiple files.
  283.    -Z   = Route output to disk or another port.
  284.    -Bx  = Biases font selection toward larger or smaller fonts.
  285.    -Ux  = Automatic margin and column width adjustment.
  286.    -Xx  = Print an exact number of pages/column keeping page breaks.
  287.    -H   = Select a thin (light) font
  288.    -Yx  = Customize default settings
  289.  
  290.   Defaults: 80 characters/column;96 lines/page;1 consecutive blank
  291.            line; no pause before printing page; do not number pages;
  292.            wrap (not truncate) long lines;4 blank lines at top of
  293.            page.
  294.  
  295.  
  296.  
  297.  
  298. Description of options
  299.  
  300.  
  301.    -Lxxx
  302.  
  303.       Each column will contain xxx lines of data. Line spacing will
  304.       be automatically adjusted to fill the page. As more lines per
  305.       page are requested smaller fonts are automatically selected.
  306.  
  307.  
  308.  
  309.     -Cxx
  310.  
  311.       Pages of text frequently contain many blank lines of data.
  312.       Experience has shown that most of these can be discarded
  313.       without sacrificing readability. This option specifies that
  314.       when there are more than xx consecutive blank lines, the
  315.       excess will be discarded. The default value is 1.
  316.  
  317.  
  318.     -Sxx
  319.  
  320.       This feature is useful if you have a paper jam or decide to
  321.       print part now and part later. Using this option will cause xx
  322.       pages to be skipped before printing begins. For example,
  323.       specifying "-S2" will cause printing to begin with page 3.
  324.       When using -S with the -O or -E options, remember to count all
  325.       pages - odd and even.
  326.  
  327.     -O
  328.  
  329.       This and the -E option allow you to print on both sides of
  330.       each sheet of paper. By specifying "-O", only the odd numbered
  331.       pages will be printed. When printing is complete,reload the
  332.       paper back into the feeder so that it will print on the blank
  333.       side and rerun JETCOL using the -E option.
  334.  
  335.       Alternatively, JETCOL will ask you whether you want to print
  336.       even pages after it has finished printing the odd. Respond "Y"
  337.       after the paper has been reloaded or type "X" to terminate.
  338.  
  339.     -E
  340.  
  341.       Prints only even numbered pages. When using this option after
  342.       the -O option be sure to use a left margin setting of 0 to
  343.       allow space for hole punching or other binding requirements on
  344.       the right side of the sheet (this adjustment is made
  345.       automatically when using the automargin option).
  346.  
  347.  
  348.     -Wxx
  349.  
  350.       This option specifies how many characters will print across
  351.       each column. Wrapping or truncating will begin at this
  352.       position. It also determines the print pitch. The more
  353.       characters/column you specify the smaller the space between
  354.       characters.
  355.  
  356.  
  357.     -P
  358.  
  359.       Program will pause before printing each page. Hit any key to
  360.       print a page. This option is useful if you are feeding single
  361.       sheets to the printer.
  362.  
  363.  
  364.     -Nx
  365.  
  366.       This will cause the filename and page number to be printed in
  367.       the lower left-hand corner of each sheet. To avoid confusion
  368.       when using the -S, -O and -E options the page numbering is not
  369.       reset for each document when multiple documents are specified
  370.       on the command line(registered version only).
  371.  
  372.       If x=2 the current date will also be printed at the bottom. If
  373.       x=1 or blank only the filename and page number will print.
  374.  
  375.     -D
  376.  
  377.       If you need to keep track of each source page, this option
  378.       will print a dashed line with a page number in the middle
  379.       whenever a form feed is encountered or after 66 lines of data.
  380.       Experience has shown that this option will be rarely used
  381.       because most documents either number their own pages or it is
  382.       just not important to keep track of original page breaks.
  383.  
  384.  
  385.     -T
  386.  
  387.       Normally when lines longer than the specified column width are
  388.       encountered,JETCOL will wrap the data to the next line. If you
  389.       prefer to truncate or discard excess characters on a line, you
  390.       should invoke this option.
  391.  
  392.  
  393.     -Fx
  394.  
  395.       JETCOL will insert x blank lines at the top of each page
  396.       before printing. The default is 4.
  397.  
  398.  
  399.     -Mx
  400.  
  401.       This command sets the left margin x spaces from the edge of
  402.       the page. Default is 9. This option also affects print pitch.
  403.       The wider the margin you request the more crowded the
  404.       characters will be on the page.
  405.  
  406.  
  407.     -Rx
  408.  
  409.       Creates a right margin x spaces wide (in addition to the 1/3"
  410.       non-printing area already on right side).Default is 0.
  411.  
  412.     -?
  413.  
  414.       Instructs JETCOL to ask for files to print once it is running.
  415.       You can specify files both on the command line and when 2COL
  416.       asks for filenames. Separate the file names with spaces. This
  417.       option is useful when JETCOL is run from a menu or a Windows
  418.       icon.
  419.  
  420.     -V
  421.  
  422.       This option prescans the document and tells you many pages
  423.       (odd+even) will print. If you are printing only odd or even,
  424.       you must divide by two.
  425.  
  426.       If the last page is only partially filled you will be given
  427.       the option to compress the line spacing to eliminate the
  428.       partial page or increase the spacing to fill it. "C"
  429.       compresses the lines. "E" expands the lines. "N" preserves
  430.       the original spacing.
  431.  
  432.       If you are printing multiple documents without the Append (-A)
  433.       option or using the fiXpage (-X) option, you will not be able
  434.       to modify the line spacing.
  435.  
  436.       Note: It is impossible to always adjust the spacing to exactly
  437.             fill the page. JETCOL will come as close as possible.
  438.  
  439.  
  440.     -&xx
  441.  
  442.       Wordwrap lines to a maximum of xx characters. When this option
  443.       is off (default), JETCOL will wrap in mid word.
  444.  
  445.       This wordwrap feature is intended for printing some word
  446.       processor documents (such as .WRI) where carriage return/
  447.       linefeeds occur only at the end of paragraphs. The current
  448.       implementation is not intended to reformat a document to
  449.       increase the length of lines which have CR/LFs at the end.
  450.  
  451.       Some wordprocessor programs imbed graphics and other control
  452.       information in their files. The wordwrap feature eliminates
  453.       ASCII characters outside of the range 32-126. This will
  454.       greatly reduce but not eliminate "garbage" when printing these
  455.       files. WRI files, for example, have graphics at the end and
  456.       you will almost always see at least a few lines of garbage
  457.       when printing unconverted .WRI files.
  458.  
  459.  
  460.       ***Options below are active only in the registered version***
  461.  
  462.     -A
  463.  
  464.       When multiple files are specified on the command line
  465.       (registered version only) you have the option of either
  466.       starting a new page for each file (default) or appending them
  467.       as though they were one continuous file. The -A option causes
  468.       them to be appended.
  469.  
  470.  
  471.     -Zfilename
  472.  
  473.       Allows output to be routed to a file instead of to the
  474.       printer. The file can then be printed in background while
  475.       running other programs. For example, to send output to a file
  476.       called PRINT.TXT, you should include -ZPRINT.TXT on the
  477.       command line.If PRINT.TXT does not exist, it will be created.
  478.       If PRINT.TXT already exists, JETCOL output will be appended to
  479.       the end of the file. This command is only active in the
  480.       registered version of JETCOL. This option can also be used to
  481.       redirect output to LPT2, COM1, COM2, etc.
  482.  
  483.  
  484.     -Bx
  485.  
  486.       This option biases the font selection to pick either a larger
  487.       or smaller font than would ordinarily chosen by JETCOL.
  488.       Setting x to 1 picks the next larger font. If x is set to -1,
  489.       it picks the next smaller font. If x is set to 2, it will skip
  490.       two font sizes larger, and so on. This option is active for
  491.       registered users only. Examples: -B1,-B2,-B-1,-B-2...etc. (do
  492.       not insert any spaces).(registered version only)
  493.  
  494.  
  495.     -Ux
  496.  
  497.       X is the number of left margin spaces you request. JETCOL
  498.       scans the entire document to be printed to determine its
  499.       formatting. Leading blanks in the document are taken into
  500.       account to give you the exact left margin you requested.
  501.       Column width is adjusted to accommodate the widest line
  502.       in the document. The result is that lines are fully spread
  503.       across the page and character spacing is maximized for best
  504.       readability. (registered version only)
  505.  
  506.  
  507.       The automargin option automatically puts the margin you
  508.       requested on the right side of the page (for binding) if you
  509.       are printing with the -E option (on the reverse side of the
  510.       page.)
  511.  
  512.       Automargin automatically turns on the wordwrap feature (-&)
  513.       whenver lines longer than the columnwidth (-W) are encountered
  514.       in a document if the truncate (-T) option is off.
  515.  
  516.     -H
  517.  
  518.       Selects a light (thin) font instead of the standard font. If
  519.       the thin font in the required size is not available the
  520.       regular, bolder, font is substituted. The only thin fonts
  521.       supplied with the standard registered version are sizes 6 and
  522.       7.(registered version only)
  523.  
  524.  
  525.     -Xx
  526.  
  527.       Prints exactly x pages/column retaining original formatting
  528.       and page breaks. The value of x may be from 1 to 3.(registered
  529.       version only)
  530.  
  531.     -Yx
  532.  
  533.       The -Y option allows you to modify JETCOL's default settings.
  534.       This MUST always be the first option on the command line
  535.       whenever you use it.
  536.  
  537.       Typing "JETCOL -Y1 <enter>" will cause JETCOL to display all
  538.       current default settings.
  539.  
  540.       Typing "JETCOL -Y2 [options....] <enter>" will cause JETCOL to
  541.       permanently remember those options by modifying the JETCOL.EXE
  542.       program itself. Your personal registration code MUST always be
  543.       one of the options specified whenever you modify the default
  544.       settings. Whenever the -Y2 option is used, any options not
  545.       specified on the command line will be reset to the standard
  546.       defaults. Therefore, even if you change only one of your
  547.       custom options, you must reenter them all at the same time.
  548.       The next time you run JETCOL the options you specified will
  549.       automatically be used.
  550.  
  551.       For example, if you want to set the number of lines/page to
  552.       102 and print the page numbers at the bottom, you would type:
  553.       JETCOL -Y2 -L102 -N registration code# <enter>. The next time
  554.       you type JETCOL [filename] <enter> It would be as though you
  555.       had typed: JETCOL -L102 -N registration code# [filename].
  556.  
  557.       If there are several different option profiles you wish to
  558.       use, you can create different copies of JETCOL.EXE with
  559.       different names, such as JETCOL1.EXE, JETCOL2.EXE, etc. The
  560.       -Y2 option only modifies the EXE file having the same name and
  561.       path that you type on the command line.
  562.  
  563.       All defaults with an 'x' value can be temporarily overridden
  564.       with a different value on the commmand line. Use an 'x' value
  565.       of 0 to temporarily deactivate Automargin or Pagefix.Any
  566.       option without an 'x' value can be activated simply by putting
  567.       it on the command line. To temporarily deactivate an option
  568.       set as a permanent default, type a minus after the option. For
  569.       example, to temporarily deactivate the N option, you would put
  570.       -N- on the command line: JETCOL -N- [filename]
  571.  
  572.       THIS FUNCTION WILL NOT WORK ON .EXE FILES THAT HAVE BEEN
  573.       COMPRESSED WITH PKLITE. You must first decompress, use the -Y2
  574.       option and then recompress.
  575.  
  576.  
  577.  
  578. Using JETCOL with a word processor
  579.  
  580.     The wordwrap feature (-&) provides a useful, but not always
  581.     perfect,way of printing many wordprocessor (such as .WRI) files.
  582.     In those cases where you cannot get a satisfactory printout
  583.     directly from a document in its original form, most word
  584.     processors have what is called an ASCII output or DOS output
  585.     mode which JETCOL will work with.
  586.  
  587.     For example, with WordPerfect, you can create a JETCOL usable
  588.     file with the sequence: Control-F5,1,Save. Wordperfect also
  589.     supplies a freestanding program called CONVERT.EXE. When
  590.     combined with JETCOL in a batchfile it allows WP documents to be
  591.     printed directly with one command.
  592.  
  593.     The JETCOL registration disk provides shareware reformatting
  594.     programs which may help in printing other wordprocessor formats.
  595.     If you specify your word proccessor when registering, I may be
  596.     able to provide you with a conversion program.
  597.  
  598.  
  599.  
  600. Distribution
  601.  
  602.     Permission is hereby given to copy and distribute this program
  603.     as long as no more than $10 is charged. It must be made clear to
  604.     the buyer that this is only a handling charge and not a
  605.     registration fee.Please include all files in their original
  606.     unmodified form when distributing this program. Permission to
  607.     distribute may be revoked by the author at any time for any
  608.     reason.
  609.  
  610.     If you list JETCOL in a catalog,I would appreciate a copy of the
  611.     catalog to be sure that the description is correct. I will also
  612.     then know to send you updated versions as they become available.
  613.  
  614.     YOU MUST NOT DISTRIBUTE ANY COPY WHICH HAS BEEN BRANDED WITH
  615.     A REGISTRATION CODE. A program can be unbranded by typing
  616.     JETCOL -Y2 <enter>.
  617.  
  618. All trademarks used in this document are the property of their
  619. owners.
  620.  
  621.                                                      -Tony Caine-
  622.  
  623. GEnie mail:A.CAINE
  624.